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ABOUT THIS CHAPTER 


This chapter discusses the Floating-Point Arithmetic Package and the 
Transcendental Functions Package, which provide facilities for extended- 
precision floating-point arithmetic and advanced numerical applications 
programming. These two packages support the Standard Apple Numeric Environment 


(SANE), which is designed in strict accordance with IEEE Standard 754 for Binary 
Floating-Point Arithmetic. 


You should already be familiar with packages in general, as discussed in the 
Package Manager chapter. 
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ABOUT THE PACKAGES 


Pascal programmers will rarely, if ever, need to call the Floating-Point 
Arithmetic or Transcendental Functions packages explicitly. These facilities are 
built into most Macintosh high-level languages); that is, the compiler 
recognizes SANE data types, and automatically calls the packages to perform the 
standard arithmetic operations (+, -, *, /) as well as data type conversion. 
Mathematical functions that aren't built in are accessible through a run-time 
library—see your language manual for details. 


If you're using assembly Language or a language without built-in support for 
SANE, you'll need to be familiar with the Apple Numerics Manual. This is the 
standard reference guide to SANE, and describes in detail how to call the 
Floating-Point Arithmetic and Transcendental Functions routines from assembly 
language. Some general information about the packages is given below. 


The Floating-Point Arithmetic and Transcendental Functions packages have been 
extended to take advantage of the MC68881 coprocessor. Using the routines in 
these packages (described fully in the Apple Numerics Manual) will ensure 
compatibility on all past and future versions of the Macintosh; in addition, 
when the 68881 is present, floating-point performance will be improved, on 
average, by a factor of 7 or 8 over the Macintosh Plus. 


While taking advantage of the speed of the 68881, the precision of the routines 
in both packages has been preserved. 


Warning: Certain highly-specialized applications will want to access 
the 68881 directly; be aware, however, that doing this virtually 
ensures that your application will not function on other, past 
and perhaps future, versions of the Macintosh. Moreover, the 
transcendental functions provided by the 68881 are actually less 
precise than the corresponding functions in the Transcendental 
Functions package. 


To promote long word alignment of operands, the 68881 stores its extended type 
in a 96-bit format, putting 16 bits of filler between the 16-bit sign/exponent 
and the 64-bit significand. These 16 filler bits make the mixing of SANE calls 
and direct access of the 68881 a tricky business. 
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THE FLOATING-POINT ARITHMETIC PACKAGE 


The Floating-Point Arithmetic Package contains routines for performing the 
following operations: 


Arithmetic and Auxiliary Routines 


Add 

Subtract 

Multiply 

Divide 

Square Root 

Round to Integral Value 
Truncate to Integral Value 
Remainder 

Binary Log 

Binary Scale 

Negate 

Absolute Value 

Copy Sign 

Next-After 


Converting Between Data Types 


Binary to Binary 
Binary to Decimal Record (see note below) 
Decimal Record to Binary 


Comparing and Classifying 


Compare 
Compare, Signaling Invalid if Unordered 
Classify 


Controlling the Floating-Point Environment 


Get Environment 

Set Environment 

Test Exception 

Set Exception 

Procedure Entry Protocol 
Procedure Exit Protocol 


Halt Control 


Set Halt Vector 
Get Halt Vector 


Note: Don't confuse the floating-point binary-decimal conversions with 
the integer routines provided by the Binary-Decimal Conversion Package. 


The following data types are provided: 
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Single (32-bit floating-point format) 

Double (64-bit floating-point format) 

Comp (64-bit integer format for accounting-type applications) 
Extended (80-bit floating-point format) 


eee ie 


The Floating-Point Arithmetic Package is contained in the ROM, beginning with 
the 128K ROM. 


Assembly-language note: The macros for calling the Floating-Point routines 
push a two-byte opword onto the stack and then 
invoke _FP68K (same as Pack4). These macros are 
fully documented in the Apple Numerics Manual. 


It preserves all MC68000 registers across invocations 
(except that the remainder operation modifies DO), 
but modifies the MC68000 CCR flags. 
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THE TRANSCENDENTAL FUNCTIONS PACKAGE 


The Transcendental Functions Package contains the following mathematical 


functions: 
Logarithmic Functions 


Base-e logarithm 
Base-2 logarithm 
Base-e logarithm of 1 plus argument 
Base-2 logarithm of 1 plus argument 


Exponential Functions 


Base-e exponential 
Base-2 exponential 
Base-e exponential minus 1 
Base-2 exponential minus 1 
Integer exponential 
General exponential 


Financial Functions 


Compound Interest 
Annuity Factor 


Trigonometric Functions 
Sine 
Cosine 
Tangent 
Arctangent 
Random Number Generator 


Note: 


n(x) 

log(x) base 2 
Ln(1+x) 
log(1+x) base 2 


The functions in this package are also called elementary functions. 


The Transcendental Functions Package is contained in the ROM, beginning with the 
128K ROM. It in turn calls the Floating-Point Arithmetic Package to perform the 


basic arithmetic. 


Assembly- language note: 


The macros for calling the transcendental functions 


push a two-byte opword onto the stack and then 
invoke _Elems68K (same as Pack5). These macros are 
fully documented in the Apple Numerics Manual. 


It preserves all MC68000 registers across invocations, 
but modifies the CCR flags. 
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Further Reference: 


Package Manager 
Binary-Decimal Conv Pkg 


END OF DOCUMENT 
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